home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1994 January / PSL Monthly Shareware CD-ROM (Public Software Library) (January 1994).iso / games / dos / strategy / mlpush.com / MLPUSH.DOC < prev    next >
Encoding:
Text File  |  1990-07-07  |  13.9 KB  |  422 lines
  1.               MicroLink Personal Computer Users' Group
  2.  
  3.                              Presents
  4.  
  5.                           Push Your Luck
  6.  
  7.                  v1.1, Copyright 1990, Bob Lancaster
  8.  
  9.  
  10. INTRODUCTION
  11.  
  12.    Push Your Luck is a fast, straightforward dice game, in which
  13.    players try to use a little strategy and a lot of luck in order to
  14.    run up the highest score.
  15.  
  16.    Based on an old dice game with the lovely name of "Drop Dead", Push
  17.    Your Luck includes a few twists which I think add to the fun.
  18.  
  19.    Enjoy!
  20.  
  21.  
  22. EQUIPMENT REQUIRED
  23.  
  24.    Push Your Luck will run on any IBM PC/AT/XT/PS2 or close clone
  25.    thereof, with at least 100k of memory available after DOS is
  26.    loaded.
  27.  
  28.    Although the game looks best when played on a color monitor, it
  29.    plays just fine on a monochrome.  (If you are using a monochrome or
  30.    composite monitor with a color graphics card, please see "Black And
  31.    White Mode" in the Command Line Parameters section below)
  32.  
  33.    A Microsoft-compatible mouse can be used.  (Remember to load your
  34.    mouse driver before starting Push Your Luck).
  35.  
  36.    If you run across a configuration on which the game will not run,
  37.    please let me know (address at end of this file)!
  38.  
  39.  
  40. GAME FEATURES
  41.  
  42.       Microsoft Mouse Support
  43.       Fast Mode
  44.       Monochrome/Composite monitor support
  45.       Top Ten Scores file
  46.       Statistics on multiple games
  47.       Bosskey
  48.       Computer Opponent
  49.       On-line help
  50.  
  51.  
  52. THE OBJECT
  53.  
  54.    In Push Your Luck, you start each round by rolling two "Blocker"
  55.    dice.  These are displayed in a window in the upper left corner of
  56.    the screen.
  57.  
  58.    You then begin rolling five dice.  Any dice which match either of
  59.    the "Blocker" dice are discarded, and the rest are added to your
  60.    score for that round, at face value.
  61.  
  62.    If you have any dice left, you are asked whether you want to stop
  63.    rolling, or "push your luck" by rolling again.
  64.  
  65.    Why is it pushing your luck?  Because if you lose all of your
  66.    remaining dice during a round before stopping, you lose all the
  67.    points you had accumulated during that round!
  68.  
  69.    This makes it crucial for you to decide just how far you should
  70.    push your luck, taking into account such factors as:
  71.  
  72.       How many dice are left?
  73.  
  74.       Are your "Blockers" a pair (giving you in effect only one
  75.       "Blocker" to worry about)?
  76.  
  77.       What is your score compared to your opponents?
  78.  
  79.       What round is it?
  80.  
  81.       And - how lucky do you feel?
  82.  
  83.  
  84. SCORING
  85.  
  86.    After each "Push", the dice rolled which do NOT match either of the
  87.    "Blockers" are added to your score for the round.
  88.  
  89.    If you stop before losing all your dice, you get to keep the score
  90.    you have run up during the round.
  91.  
  92.    If however, you lose all the dice, all points earned during that
  93.    round are unceremoniously taken away!  (Any scores from prior
  94.    rounds are still yours.  I'm not THAT cruel.)
  95.  
  96.    At the end of five rounds, the player with the highest score wins!
  97.  
  98.  
  99. STARTING THE GAME
  100.  
  101.    At this point, you should be able to play the game, and get a feel
  102.    for it.  You can read the rest of this document now at your leisure
  103.    to clarify points, and to explain some of the features you might
  104.    not understand your first few times through the game.
  105.  
  106.    So, make sure you are in DOS, and type "MLPUSH" (without the
  107.    quotes) and press return.  Follow the prompts, and enjoy!
  108.  
  109.  
  110. GAME CONTROLS
  111.  
  112.    Push Your Luck can be played either using the keyboard or a
  113.    Microsoft-compatible mouse.
  114.  
  115.  
  116.    KEYBOARD INPUT
  117.  
  118.       The legend (the last line on the screen) always contains a list
  119.       of keys that are valid at any point in the game, usually along
  120.       with a one-word description of their function. (See "COMMANDS"
  121.       below)
  122.  
  123.  
  124.    MOUSE INPUT
  125.  
  126.       Most of the keys listed on the bottom line of the screen can be
  127.       entered via the mouse by pointing to the command and clicking
  128.       the left button of the mouse.  (If you are new to mice,
  129.       "clicking" something means to place the mouse cursor on it and
  130.       press the appropriate button, in this case, the left.)
  131.  
  132.       Also, boxes higher on the screen with messages such as "Press
  133.       return for next player" will allow you to click the box itself
  134.       to continue, rather than the command at the bottom of the
  135.       screen.
  136.  
  137.       So, experiment with the mouse, and see what works.  I think it's
  138.       fairly straightforward, but would appreciate any feedback on
  139.       ways you think it could be improved (address at end of file).
  140.  
  141. COMMANDS AND TOGGLES
  142.  
  143.    A number of commands and toggles are available to enhance play, or
  144.    to allow you to tailor the game a little to suit your taste.
  145.    Alphabetically, these are:
  146.  
  147.    A (AllScores command)
  148.  
  149.       This displays a scorecard of all players, to compare how
  150.       everyone is doing in relation to each other.  The highest
  151.       score(s) are emphasized with a flashing arrow.
  152.  
  153.    B (BossKey command)
  154.  
  155.       This displays a phony DOS screen.  I'll explain for you honest
  156.       folks: this key is used when you are playing the game on company
  157.       time, and the boss suddenly appears. To return to the game, key
  158.       OK at the phony DOS prompt.  Also known by some as the SpouseKey
  159.       command.
  160.  
  161.    Esc (Exit command)
  162.  
  163.      Use this key to end MLPush before the game is over.
  164.  
  165.    F (Fast Mode toggle)
  166.  
  167.       If you just want to play the game, and not look at some of the
  168.       "animation" (such as the rolling dice), turning the Fast Mode on
  169.       will do it.
  170.  
  171.       Defaults to "No", showing all animation.
  172.  
  173.    I (Program Info)
  174.  
  175.       Displays information about the program and the author.
  176.  
  177.    N (Next Prompt toggle)
  178.  
  179.       This allows you to get rid of the "Press return for so-and-so's
  180.       turn" message, which some folks find annoying.
  181.  
  182.       Defaults to "Yes", allowing the message to show.
  183.  
  184.    P (Pips Mode)
  185.  
  186.       Allows you to select between dice with pips (dots) on them, or
  187.       with numerals on them.
  188.  
  189.       Defaults to "Yes", showing the dots.
  190.  
  191.    R (Round Prompt toggle)
  192.  
  193.       This allows you to get rid of the "Round" message, which some
  194.       folks find annoying.
  195.  
  196.       Defaults to "Yes", allowing the message to show.
  197.  
  198.    S (Sound Mode toggle)
  199.  
  200.       This allows you to turn on and off the sounds produced by the
  201.       game, which some folks find annoying.
  202.  
  203.       Defaults to "Yes", producing sound.
  204.  
  205.    T (TopTen scores command)
  206.  
  207.       Displays the highest ten scores achieved on your machine.  (This
  208.       information is stored in the file MLPUSH.SCR.  Clearing the top
  209.       ten may be done by displaying the top ten and pressing Alt-C.)
  210.  
  211.    W (Win/Loss Statistics command)
  212.  
  213.       Displays the statistics for all games played in the current
  214.       session (Since player names were entered).  These are always
  215.       shown at the end of each game, but this command allows you to
  216.       display them during play.
  217.  
  218.  
  219. COMMAND LINE PARAMETERS
  220.  
  221.    In the section above, several options are referred to as "toggles".
  222.    This simply means that they can be in a "Yes" or "No" state.
  223.  
  224.    (Note that the state of these toggles can be determined by looking
  225.    at the legend appearing at the bottom of your screen.  If the
  226.    toggle description there begins with a capital letter, the toggle
  227.    is in a "Yes" state.  For example, if a legend reads "Sound fast",
  228.    the sound toggle is set to "yes", and the fast toggle is set to
  229.    "no".)
  230.  
  231.    Each of them has a "default", which is the state (either yes or no)
  232.    in which they start out when Push Your Luck begins.
  233.  
  234.    I set the defaults to the way I felt was best, but you may think
  235.    differently!
  236.  
  237.    If you find yourself always changing one or more of the toggles
  238.    each time you play, you might want to set them on the DOS command
  239.    line instead.
  240.  
  241.    Any toggle can be flipped to the opposite of its default (Fast Mode
  242.    = "Yes", for example) by keying the toggle's letter following the
  243.    program name (MLPUSH) when you start up the game.
  244.  
  245.    So, if you wanted to set "Round Prompt" to No, and Fast Mode to
  246.    "Yes" (the opposites of their defaults), at DOS you would key:
  247.  
  248.            "MLPUSH R F"
  249.  
  250.    ...without the quotes, followed by the Return key.  Be careful that
  251.    you leave a space between MLPUSH and the toggle(s), or DOS won't
  252.    recognize what you are trying to do.
  253.  
  254.    This allows you to tailor the game a little to your taste, and if
  255.    you put this statement into a DOS batch file or menu processor, it
  256.    will save you from setting these toggles each time you start the
  257.    game.
  258.  
  259.    Toggles only valid from the command line:
  260.  
  261.    B (Black And White mode)
  262.  
  263.       If you are running a composite monitor on a color graphics card,
  264.       and the colors in MLPush are hard to discern, keying "MLPUSH B"
  265.       at the DOS prompt will make MLPush run in Black And White Mode.
  266.  
  267.       Defaults to "Yes" if Monochrome adapter detected, "No"
  268.       otherwise.
  269.  
  270.    M (Mouse)
  271.  
  272.       If you have your mouse driver installed, but do not want to use
  273.       the mouse during MLPush, keying "MLPUSH M" at the DOS prompt
  274.       will cause MLPush to ignore the mouse.
  275.  
  276.       If you run the program without this parameter, you can still use
  277.       the keyboard.  Using this parameter simply keeps the mouse
  278.       cursor from being displayed.
  279.  
  280.       If the mouse driver is not installed, this parameter has no
  281.       effect.
  282.  
  283.       Defaults to "Yes" if mouse driver detected, "No" otherwise.
  284.  
  285.    T (Top Ten Scores)
  286.  
  287.       This is different than the "T" command available during game
  288.       play.  It specifies whether a Top Ten Scores file should be
  289.       saved, and is useful if you are running the game from a write-
  290.       protected disk.
  291.  
  292.       Defaults to "Yes".
  293.  
  294.  
  295. DIFFERENCE BETWEEN VERSIONS
  296.  
  297.    VERSION 0.1  -  06/23/90
  298.  
  299.       Released to one beta tester.
  300.  
  301.    VERSION 0.2  -  06/24/90
  302.  
  303.       Lots of cosmetic changes, still unreleased.
  304.  
  305.    VERSION 1.0  -  07/04/90
  306.  
  307.       More cosmetic changes.
  308.  
  309.    VERSION 1.1  -  07/07/90
  310.  
  311.       Fix Help/Mouse bug.
  312.       Initial "public" release.
  313.  
  314.  
  315. ACKNOWLEDGMENTS
  316.  
  317.    Thanks to my wife Cindy, who play-tested the concept with me, using
  318.    real, honest-to-goodness dice, and thanks to Reed Harding for being
  319.    my beta-guinea pig.
  320.  
  321.    Thanks to all those folks who wrote nice letters and left great BBS
  322.    messages in response to my other games.
  323.  
  324.    A tip o' the hat as always to the officers and members of MicroLink
  325.    PCUG for the encouragement and support they always give my PC
  326.    endeavors.
  327.  
  328.    Thanks to Eagle Performance Software, whose Shareware product
  329.    "QWIK" allows for some blazingly fast screenwrites in Turbo Pascal
  330.    and Turbo C.
  331.  
  332.      Programmers interested in QWIK should contact Eagle at:
  333.  
  334.        Eagle Performance Software      Or Call Jim LeMay at:
  335.        TP products                       (817) 735-4833
  336.        P.O. Box 122237
  337.        Fort Worth, TX  76121-2237
  338.  
  339.  
  340. ALSO BY THE AUTHOR
  341.  
  342.    MicroLink Yaht - The popular dice game
  343.  
  344.    MicroLink Shut The Box - The traditional board game
  345.  
  346.    MicroLink Otra - A memory game in the spirit of "Simon"
  347.  
  348.    MicroLink Loyd - The "15" puzzle, in competitive game form
  349.  
  350. FEEDBACK
  351.  
  352.    I would appreciate any comments, complaints, or wish lists of
  353.    features you'd like to see!  And, if you have any favorite old
  354.    games you'd like to see programmed, I'm always looking for another
  355.    which would interest me!
  356.  
  357.    Also, if you like the game enough (and can afford) to send a small
  358.    ($5) donation, I won't argue.  And my wife will understand my long
  359.    nights at the PC a little better!
  360.  
  361.    Either way: Enjoy the game, and give copies of it to all your
  362.    friends.  And enemies.  Strangers on the street...
  363.  
  364.    I can be contacted by mail at:
  365.  
  366.       Bob Lancaster / P.O. Box 5612 / Hacienda Heights, CA  91745
  367.  
  368.    Or by modem at:
  369.  
  370.       MicroLink PCUG BBS (AKA So. Cal Builder's Board)
  371.       818/961-7903 - 24hrs/365 days - 300/1200/2400/9600
  372.  
  373.       CompuServe ID: 71141,3016
  374.  
  375.    Please include the version number of Push Your Luck in
  376.    correspondence.
  377.  
  378.    Those interested in finding out more about MicroLink can contact
  379.    the board listed above, or by mail:
  380.  
  381.       MicroLink PCUG Headquarters
  382.       15865-B E. Gale Ave. Box 1003
  383.       Hacienda Heights, CA  91745
  384.  
  385.    Tell them Push Your Luck sent you!
  386.  
  387.  
  388.          ----------------end-of-author's-documentation---------------
  389.  
  390.                         Software Library Information:
  391.  
  392.                    This disk copy provided as a service of
  393.  
  394.                         The Public (Software) Library
  395.  
  396.          We are not the authors of this program, nor are we associated
  397.          with the author in any way other than as a distributor of the
  398.          program in accordance with the author's terms of distribution.
  399.  
  400.          Please direct shareware payments and specific questions about
  401.          this program to the author of the program, whose name appears
  402.          elsewhere in  this documentation. If you have trouble getting
  403.          in touch with the author,  we will do whatever we can to help
  404.          you with your questions. All programs have been tested and do
  405.          run.  To report problems,  please use the form that is in the
  406.          file PROBLEM.DOC on many of our disks or in other written for-
  407.          mat with screen printouts, if possible.  The P(s)L cannot de-
  408.          bug programs over the telephone.
  409.  
  410.          Disks in the P(s)L are updated monthly, so if you did not get
  411.          this disk  directly from the P(s)L,  you should be aware that
  412.          the files in this set may no  longer be the current versions.
  413.  
  414.          For a copy of the latest monthly software library newsletter
  415.          and a list of the 2,000+ disks in the library, call or write
  416.  
  417.                         The Public (Software) Library
  418.                               P.O.Box 35705
  419.                            Houston, TX 77235-5705
  420.                                (713) 524-6394
  421.  
  422.